home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / f90 / pxfgetpwnam.z / pxfgetpwnam
Encoding:
Text File  |  1998-10-30  |  4.2 KB  |  103 lines
  1. PXFGETPWNAM(3F)                                        Last changed: 1-6-98
  2.  
  3.  
  4. NNAAMMEE
  5.      PPXXFFGGEETTPPWWNNAAMM - Gets password information about login name
  6.  
  7. SSYYNNOOPPSSIISS
  8.      SSUUBBRROOUUTTIINNEE PPXXFFGGEETTPPWWNNAAMM ((_n_a_m_e,, _i_l_e_n,, _j_p_a_s_s_w_d,, _i_e_r_r_o_r))
  9.      IINNTTEEGGEERR _i_l_e_n,, _j_p_a_s_s_w_d,, _i_e_r_r_o_r
  10.      CCHHAARRAACCTTEERR*_n
  11.  
  12. IIMMPPLLEEMMEENNTTAATTIIOONN
  13.      UNICOS, UNICOS/mk, and IRIX systems
  14.  
  15. SSTTAANNDDAARRDDSS
  16.      IEEE standard interface for FORTRAN 77
  17.  
  18. DDEESSCCRRIIPPTTIIOONN
  19.      On IRIX systems, this routine is in lliibbffoorrttrraann..ssoo which is linked by
  20.      default when compiling programs with the MIPSpro 7 Fortran 90 compiler
  21.      or when compiling programs with the --ccrraayylliibbss option to the MIPSpro
  22.      7.2 F77 compiler.
  23.  
  24.      The PPXXFFGGEETTPPWWNNAAMM routine uses the ggeettppwwnnaamm(3C) function to return
  25.      password information about a login name.  It uses the following
  26.      components of the ppaasssswwdd structure:
  27.  
  28.      * ppww__nnaammee: login name
  29.  
  30.      * ppww__uuiidd: user ID
  31.  
  32.      * ppww__ggiidd: group ID
  33.  
  34.      * ppww__ddiirr: default login directory
  35.  
  36.      * ppww__sshheellll: default login shell or program
  37.  
  38.      The following components are supported by the UNICOS and IRIX
  39.      operating systems, but are not part of the POSIX 1003.9-1992 standard.
  40.  
  41.      * ppww__ppaasssswwdd: encrypted password
  42.  
  43.      * ppww__aaggee: password age (character string) (unused on IRIX systems)
  44.  
  45.      * ppww__ccoommmmeenntt: comment
  46.  
  47.      * ppww__ggeeccooss: a comment in the UNICOS operating system; the user's real
  48.        name on IRIX systems.
  49.  
  50.      When using the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
  51.      UNICOS, UNICOS/mk, or IRIX systems, all arguments must be of default
  52.      kind unless documented otherwise.  On UNICOS and UNICOS/mk, default
  53.      kind is KKIINNDD==88 for integer, real, complex, and logical arguments; on
  54.      IRIX, the default kind is KKIINNDD==44.
  55.  
  56.      The following is a list of valid arguments for this routine:
  57.  
  58.      _n_a_m_e      An input character variable or array element containing the
  59.                login name for which password information is requested.
  60.  
  61.      _i_l_e_n      An input integer variable containing the character length of
  62.                _n_a_m_e. If _i_l_e_n is zero, trailing blanks are stripped.
  63.  
  64.      _j_p_a_s_s_w_d   An output handle of type ppaasssswwdd created with
  65.                PPXXFFSSTTRRUUCCTTCCRREEAATTEE(3F).
  66.  
  67.      _i_e_r_r_o_r    An output integer variable that contains zero if PPXXFFGGEETTPPWWNNAAMM
  68.                was successful or nonzero if PPXXFFGGEETTPPWWNNAAMM was not successful.
  69.  
  70.      The PPXXFFGGEETTPPWWNNAAMM routine may return the following errors:
  71.  
  72.      EENNOOEENNTT       If an entry matching the login name in _n_a_m_e was not
  73.                   found.
  74.  
  75.      EEBBAADDHHAANNDDLLEE   If _j_p_a_s_s_w_d is an invalid handle or has an incorrect
  76.                   handle type (UNICOS and UNICOS/mk systems only).
  77.  
  78. EEXXAAMMPPLLEESS
  79.      In this example, the password information will be acquired for the
  80.      login name rroooott.
  81.  
  82.           program pxftest
  83.           integer ilen, ierror, value
  84.           integer*8 jpasswd
  85.           CALL PXFSTRUCTCREATE('passwd',jpasswd,ierror)
  86.           name = 'root'
  87.           ilen = 4
  88.           CALL PXFGETPWNAM(name,ilen,jpasswd,ierror)
  89.           if (ierror .eq. 0) then
  90.              print *,'PASSED: pxfgetpwnam call'
  91.                 else
  92.              print *,'FAILED: pxfgetpwnam call with error = ',ierror
  93.           endif
  94.           CALL PXFSTRUCTFREE(jpasswd,ierror)
  95.           end
  96.  
  97. SSEEEE AALLSSOO
  98.      ggeettppwwnnaamm(3C), PPXXFFSSTTRRUUCCTTCCRREEAATTEE(3F), PPXXFFSSTTRRUUCCTTFFRREEEE(3F)
  99.  
  100.      _A_p_p_l_i_c_a_t_i_o_n _P_r_o_g_r_a_m_m_e_r'_s _L_i_b_r_a_r_y _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-
  101.      2165, for the printed version of this man page.
  102.  
  103.